feat: P0-1/P0-5 + 19 권장 거버넌스 등록 (Bitnami + PGO 교차검증) - #1

PR #1 CI Trivy fs scan fail을 해결하기 위한 의존성 업데이트.

해소 CVE:
- go.opentelemetry.io/otel/sdk: v1.36.0 → v1.43.0
  - CVE-2026-24051 (HIGH): Arbitrary Code Execution via PATH Hijacking
  - CVE-2026-39883 (HIGH): BSD kenv command not using absolute path
- google.golang.org/grpc: v1.72.2 → v1.79.3
  - CVE-2026-33186 (CRITICAL): authz bypass via improper HTTP/2 path validation

부수 변경 (go mod tidy의 결과): otel/auto/sdk v1.1.0→v1.2.1, golang.org/x/*
minor bump, google.golang.org/genproto bump, protobuf v1.36.8→v1.36.11.
모두 indirect 의존성, 코드 변경 0.

검증:
- make test: 모든 패키지 PASS
  - internal/controller 81.0% (회귀 0)
  - internal/plugin   93.0% (회귀 0)
  - internal/citus    95.4% (회귀 0)
  - internal/instance/election 97.4% (회귀 0)
  - internal/instance/fencing  89.7% (회귀 0)
- make lint: 0 issues

Refs: PR #1 CI run 25145046256 (Security scan trivy fs)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

글로벌 CLAUDE.md §2 (GitHub Actions 영구 금지, 2026-04-29 사고 트리거 —
organization billing 1건 실패 → 전 저장소 전 PR 4초 만에 fail) 적용.
본 프로젝트의 .github/workflows/{ci,upstream-watch}.yml을 폐기하고
로컬 4 계층(pre-commit · pre-push · Makefile · PR review)으로 일원화.

폐기:
- ci.yml — 5 jobs (lint, test, matrix-build, e2e, scan) 모두 로컬로 마이그
- upstream-watch.yml — Citus 신 릴리스 cron, RemoteTrigger/사용자 schedule로 대체 (후속)

신규:
- .pre-commit-config.yaml
  L1 pre-commit: golangci-lint
  L2 pre-push: go mod tidy drift, make test, make audit, gitleaks
- Makefile audit 타겟 — trivy fs --severity HIGH,CRITICAL --ignore-unfixed
- docs/adr/0009-no-github-actions-rfc-0002.md — 결정 근거 + 4 계층 매핑
- README.md "Development (로컬 게이트)" 섹션 — 1회 셋업 + PR body 증거 블록

검증:
- make lint: 0 issues
- make audit: 0 vulnerabilities (PR #1 deps fix 효과 객관 확인)
- pre-commit validate-config: PASS

후속 작업:
1. branch protection "Required status checks" 제거 (admin이 GitHub UI에서)
2. upstream-watch 대체 (RemoteTrigger / 사용자 schedule)
3. e2e cert-manager 통합 완성 PR (PR #1 fail의 진짜 fix)

Refs: 글로벌 CLAUDE.md §2, RFC 0002 (2026-04-29), ADR 0009
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

본 세션(2026-04-30) 종료 의식 — workflow.md §2 준수.
다음 세션이 대화 컨텍스트 없이 재개 가능하도록 HANDOFF.md를 본 세션 누적
상태로 갱신.

본 세션 누적:
- 6 PR 머지 (PR #1~#6 모두 admin merge, rebase, branch 자동 삭제)
- P0 권장 100% 완료 (P0-1, P0-2, P0-3, P0-4, P0-5, P0-6 phase 1)
- 거버넌스: ADR 0006/0007/0008/0009 신설, RFC 14건 매트릭스
- 글로벌 §2 정합 (.github/workflows/ 0개, 로컬 4 계층 활성)
- 차별화 1(Citus) 코드 진입 (LibPQExecutor SQL 매핑 + 7 단위 테스트)

다음 세션 후보:
1. P0-6 phase 2 (cmd/main.go LibPQExecutor 주입) — 권장 (차별화 1 완전성)
2. P7 cert-manager 통합 (PR #1 e2e fail 진짜 fix)
3. P1-4 Helm chart 골격 (ADR 0007 implementation)
4. P1-1 BackupJob CRD (Plugin SDK 첫 호출자)

차단점:
- PR #1 e2e fail은 GH Actions 폐기로 PR-blocking 효과 해소.
  진짜 fix는 후보 2.

Refs: workflow.md §2 종료 의식, plan §14
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

본 세션(2026-04-30) 8 PR 머지 결과를 TASKS.md "품질 개선 plan" P0 표에 반영.

변경:
- P0-2/P0-3/P0-4: 설계 → 완료 (각각 ADR 0006/0008, ADR 0006 §NetworkPolicy)
- P0-6: 설계 → phase 1+2a 완료 (phase 2b/3은 후속)
- 비고 컬럼 → 완료 commit hash + PR 번호 매핑 (추적 가시성)

본 세션 P0 영역 100% 도달:
- P0-1 ✓ 4ec8162 (PR #1) — Status.Conditions reason 6개
- P0-2 ✓ ae3e4e6 (PR #3) — 데이터플레인 SecurityContext defaults
- P0-3 ✓ 5bc0199 (PR #5) — NetworkPolicy 3개 활성화
- P0-4 ✓ fa24a66 (PR #4) — Cascade delete envtest
- P0-5 ✓ 4623277 (PR #1) — AuthPlugin.RotateSecret
- P0-6 phase 1+2a ✓ 33fef9a (PR #6) + 7efbdaf (PR #8) — LibPQExecutor + env-opt-in

Refs: plan §4 P0 표, HANDOFF.md (PR #7로 갱신됨)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

본 세션(2026-04-30) 12 PR 머지 결과를 docs에 통합 반영.

변경:
- README.md "Quickstart (Helm — P1-4 alpha)" 섹션 신설 — helm install +
  LibPQExecutor opt-in + multi-cluster env var 패턴 안내
- HANDOFF.md "현재 상태" + "본 세션 머지된 PR 12개" 표 + "권장 완료율" 갱신,
  "다음 단계 후보" 7개 + 권장 진입(후보 1 e2e cert-manager) 명시
- TASKS.md "P1" 표에 P1-4/P1-6 완료 마킹 + commit hash 매핑

본 세션 최종 누적:
- 12 PR 머지
- P0 100% (6/6) — Status reason / SecurityContext / NetworkPolicy / Cascade /
  AuthPlugin Rotate / LibPQExecutor(phase 1+2a+2b)
- P1 33% (2/6) — P1-4 Helm chart, P1-6 BackupOptions.ExecutionMode
- 차별화 1 phase 2 완전 완성 (multi-cluster ctx-based DSN lookup)
- ADR 0006/0007/0008/0009 (4 신설)
- 글로벌 §2 정합 (.github/workflows/ 0개, 로컬 4 계층 활성)

다음 세션 권장 진입: 후보 1 — e2e cert-manager 통합 (PR #1 e2e fail 진짜 fix).

Refs: workflow.md §2 종료 의식, plan §14
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

R3 commit chain (e501ab4 → 30f88a6) 가 compile-only 검증만 완료. 첫 실 kind
실행에서 unit/envtest 가 catch 못 하는 환경 정합성 회귀 5 건이 한 번에
드러남. 모두 fix-forward 로 정정 — RTO < 30s 측정의 전제.

  1. hack/smoke.sh:72 — namespace 'postgres-operator-system' (ql 누락) →
     실제는 'postgresql-operator-system'. wait NotFound → 5분 timeout.
  2. hack/smoke.sh OPERATOR_IMG — ':smoke' 가 install.yaml ':0.3.0-alpha'
     와 drift → ImagePullBackOff. Chart.yaml appVersion 에서 도출 (Makefile
     IMAGE_TAG 와 동일 출처).
  3. hack/smoke.sh NS env override — sample CR 의 hardcoded
     metadata.namespace=default 와 어긋남. 부모 shell 의 NS=dev 가 STS wait
     를 dev namespace 로 보내 false-negative timeout. NS hardcode 'default'.
  4. test/e2e/e2e_suite_test.go BeforeSuite — operator install 단계 자체
     누락 + managerImage tag 가 install.yaml 과 drift. make build-installer
     IMG=... + kubectl apply -f dist/install.yaml + wait Available 추가.
  5. test/e2e/{failover,postgrescluster}_e2e_test.go — label selector
     'postgres.keiailab.io/cluster=' 가 controller 의 실제 라벨
     'app.kubernetes.io/instance=' 와 불일치. Pod selector 영원히 zero
     match → BeforeAll 5분 Eventually timeout. 6 occurrence 일괄 정정.

검증:
  make lint           : 0 issues
  go test ./...       : 모든 패키지 PASS (controller/election/fencing/
                        supervise/plugin/sharding/version/webhook)
  ./hack/smoke.sh     : SUCCESS — quickstart cluster Ready 18s, psql 1=1
  make test-e2e-failover (RTO 측정):
    - It #1 elects ord-0 as initial primary           PASS
    - It #2 spawns ord-1 as standby (role=replica)    PASS
    - It #3 promotes new primary RTO < 30s            PASS (RTO=7.45s)
    - It #4 old primary rejoins as standby             FAIL (R3 후속 — bootstrap
                                                       container rejoin 분기 부재)

Refs: RFC 0006 §1 (검증되지 않은 기능이 vaporware — 본 수정은 그 원칙이
*테스트 코드 자체*에 적용된 사례), §7 beta 게이트.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

본 cycle 이 R1+R2+R3 commit chain 의 첫 실 kind 측정. RFC 0006 §4 Phase 표
의 alpha (R1+R2) + beta (R3) 측정 게이트를 동시에 검증.

§A smoke 회귀 (`hack/smoke.sh`):
  - operator manager Available     ~12s
  - CR apply → cluster Ready       18s    (이전 cross-validation 62s
                                          대비 3.4× 개선 — readinessProbe
                                          5s 단축 + R1/R2 정착 누적)
  - psql round-trip                PASS
  - status.conditions[Ready]       True ('all subsystems ready')

§B RFC 0006 R3 회귀 (`make test-e2e-failover`):
  - It #1 ord-0 initial primary             PASS
  - It #2 ord-1 standby (role=replica)      PASS
  - It #3 RTO < 30s                         PASS (RTO=7.45s, 4× 여유)
  - It #4 old primary rejoin as standby     FAIL (알려진 R3 gap)

§C It #4 의 알려진 한계 (R3 implementation gap):
  - 옛 primary 가 Pod 로 강제 종료 (graceful demote 아님) 시
    OnStoppedLeading callback 미호출 → standby.signal 미작성.
  - bootstrap container (R3 task-b) 는 first boot (PGDATA empty) 만
    standby.signal 생성. rejoin (PGDATA 존재) 분기 부재.
  - fix scope: bootstrap container 가 election lease 를 읽어
    leader != self 일 때 standby.signal touch — 별도 R3 후속 task.

§D Phase 게이트 (RFC 0006 §4):
  - alpha   : 코드 ✅ + 측정 ✅ (smoke Pod Ready 18s < 60s)  → 통과
  - beta    : 코드 ✅ + 측정 ⚠️ (RTO 7.45s ✅ / It #4 ❌)   → 부분 통과

§E 본 cycle 에서 한 commit 으로 묶인 fix 5 건 (별도 commit 9994e38):
  smoke namespace ql / smoke image tag drift / smoke NS env /
  e2e managerImage drift + operator install missing /
  e2e label selector wrong (6 occurrence). 모두 unit + envtest 가
  catch 못 하는 환경 정합성 — RFC 0006 §1 'vaporware' 원칙이 *테스트
  코드 자체에* 적용된 사례.

Refs: RFC 0006 §4 (Phase) + §7 (측정 가능한 성공 기준).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…p v0.3.0-alpha.19 (#127)

Sprint S3: Enable WAL archiving when spec.backup.enabled=true.

Changes:
- renderPostgresConf now emits archive_mode=on, archive_command, and
  archive_timeout=60 when backup is enabled on the cluster
- archive_command uses pgbackrest archive-push with cluster name as stanza
- Version bump: 0.3.0-alpha.18 → 0.3.0-alpha.19 across all manifests

Gap analysis impact:
- P0 #1 (WAL archiving): archive_command wiring DONE

Signed-off-by: Claude (postgres-operator) <support@masblue.studio>
Co-authored-by: Claude (postgres-operator) <support@masblue.studio>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Update GAP-ANALYSIS.md (en/ko/ja/zh) to reflect actually implemented
features:
- P0 #1 WAL archiving: ✅ Done (PR #127)
- P0 #4 Config hot-reload: ✅ Done (PR #126)
- P0 #5 Retention cleanup: ✅ Done (PR #130)
- P1 #6 Switchover: ✅ Done (PR #129)
- P1 #9 pg_hba.conf reload: ✅ Done (PR #126)

Signed-off-by: Claude (postgres-operator) <support@masblue.studio>
Co-authored-by: Claude (postgres-operator) <support@masblue.studio>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

ROUTER-GAP-ANALYSIS §6 백로그 항목 완료 + 연결 고정 경고를 해소됨으로
교체, WORK_HANDOFF §6.6 우선순위 갱신(per-query 완료 → 분산 수치가 #1).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: per-query extended·분산수치 1차 완료 표기, 새 #1=멀티호스트
수평스케일 실증·#2=라우터 오버헤드 개선. ROUTER-GAP-ANALYSIS: extended per-query
완료로 "pin-on-first 유지" stale 노트 정정.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6 + ROUTER-GAP-ANALYSIS §능력사다리: 읽기→replica·reference
table·resharding 데이터이동 core 완료 표기. 새 우선순위 #1=ShardSplitJob 컨트롤러
K8s 결선, #2=bufio 라우터 최적화, #3=멀티머신 수평스케일 실측.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: bufio 완료(unprepared +50%, prepared 1shard +34%). 새 우선순위
#1=ShardSplitJob 컨트롤러 K8s 결선, #3=멀티머신 수평스케일, #4=멀티 라우터 인스턴스.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6 + ROUTER-GAP-ANALYSIS: InitialCopy 가 K8s Job(내부 trust)으로
데이터 복사 + 완료 게이트(envtest 검증). 새 #1=full e2e + Cutover write-block +
Cleanup row-delete + CDC.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: InitialCopy+Cleanup 결선 완료(데이터경로 닫힘). 새 #1=full e2e +
Cutover write-block + CDC.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: write-block 완료(라우터 단위+envtest+라이브). 새 #1=멀티샤드
full e2e + CDC 증분.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6 + ROUTER-GAP-ANALYSIS: full e2e(kind 실 K8s+실 PG) 성공 — 전 phase
동작, t0=44/t1=56/source=0 키유실0, ShardRange flip, write-block 해제. 새 #1=CDC 증분
catch-up, #2=resharding 운영화(인덱스 복제·RESHARD_COPY_IMAGE manager env·target 승격).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: CDC 메커니즘(논리복제 pub/sub + DeleteForeignRange + wal_level=logical)
완료·라이브검증(라이브 쓰기 유실0). 새 #1=CDCCatchup phase 컨트롤러 결선(online/offline
모드 선택).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: online 무중단 모드(spec.Online + reconcileCDC: cdc-setup→write-block
→cdc-finalize) 완료·envtest. 새 #1=online 멀티샤드 full e2e(동시쓰기 부하하).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ

WORK_HANDOFF §6.6: online resharding full e2e(kind 실 K8s+PG) 성공 — CDCCatchup(cdc-setup
→write-block→cdc-finalize)→Completed, t0=44/t1=56/source=0 키유실0 + kv_pkey 복제 + flip.
offline+online 양 경로 라이브 검증 완료. 새 #1=native 라우터 동시쓰기 무중단 실증 + target
영구 승격.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TnVYb8dUQFg2GSiSwo1dtZ